home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga3 / paddltoy.lha / PaddleToy.doc < prev    next >
Text File  |  1993-10-28  |  5KB  |  129 lines
  1.  
  2.     ######              ##      ##  ##        ######
  3.     ##   ##             ##      ##  ##          ##
  4.     ##   ##  ####    #####   #####  ##   ####   ##   ####   ##  ##
  5.     ######      ##  ##  ##  ##  ##  ##  ##  ##  ##  ##  ##  ##  ##
  6.     ##       #####  ##  ##  ##  ##  ##  ######  ##  ##  ##  ##  ##
  7.     ##      ##  ##  ##  ##  ##  ##  ##  ##      ##  ##  ##   ####
  8.     ##       #####   ####    ####   ##   ####   ##   ####     ##
  9.                                                             ###
  10.     Version 1.00
  11.  
  12.  
  13.                                 QUICK INFO
  14.  
  15.  
  16. PaddleToy  is a program to test proportional devices plugged to the second
  17. mouse port.  If you are building your own paddles or proportional joystick
  18. this is a must for you to test and tune-up your devices.
  19. It  has enough bells and whistles for my taste, but one of the limitations
  20. is that it works only with the built-in second mouse port:  anyway I think
  21. it will be enough for the 99.99% of the programmers among you.
  22. I'll be a little brief, because I think the program is enough intuitive...
  23.  
  24.  
  25.                                   USAGE
  26.  
  27.  
  28. You can either run PaddleToy from CLI or from Workbench.
  29. If nobody else is using the second mouse port the program's graphical user
  30. interface  will  appear.
  31.  
  32. If  nothing  is plugged in the second mouse port you may notice some weird
  33. and unstable values, this is normal.
  34.  
  35. TO QUIT THE PROGRAM click on the close gadget of the PaddleToy window.
  36.  
  37.  
  38. WINDOW TITLEBAR:   I added a  vertical blank interrupt server  to read the
  39.                    potentiometers' values. This server will be active only
  40. when  the  window  is  active;  that is the why of the "server (in)active"
  41. sentence in the titlebar.
  42.  
  43.  
  44. TWO ANALOG BARS:   The  leftmost shows DATRX (pin 5), the  rightmost shows
  45.                    DATRY (pin 9).  When  the  bar  moves  to  the left the
  46. impedance is reducing (going to 0).
  47.  
  48.  
  49. TWO DIGITAL DISPLAYS:   The  numbers  below the two bars show the hardware
  50.                         registers  contents  (AND NOT  the impedance). You
  51. can  toggle  between  decimal  and hexadecimal numeric base by clicking on
  52. each display.
  53.  
  54.  
  55. "SAMPLING DELAY" GADGET:   On  slow  Amigas the sampling may take too much
  56.                            processor time. You can tell the program to run
  57. slower  and  leave  processor  time  to  other  tasks.   If you do so, the
  58. sampling  may  look quite "glitching".  Some good delay values may be 1, 2
  59. or 3 (valid values, however, are all the numbers between 0 and 1000).
  60. The  delay  value is the number of IntuiTicks to wait between a sample and
  61. another.   If  you  temporary  need processor time just inactive PaddleToy
  62. window and the task will go to sleep until the window will be reactivated.
  63.  
  64.  
  65. SYSTEM REQUEST:   This requester will appear only if the second mouse port
  66.                   is in use by another task.
  67. If  the  POTGO  word  appears  in the first line of the message's body the
  68. low-level  allocation  failed (potgo.resource:  someone is already using a
  69. proportional  control); otherwise there has been a problem with high-level
  70. allocation  (gameport.device:   someone  is  using  the  port).
  71. If  this  requester appears, you may click on the "Gosh!" gadget or simply
  72. click outside the requester to immediately quit the program.
  73.  
  74.  
  75.                                    BUGS
  76.  
  77.  
  78. I  Tested  PaddleToy on a A500, A1200 and a A3000 under kickstarts 2.0/3.0
  79. without  any  problem,  but I cannot figure out why my server (at priority
  80. -1) hangs the vertical blank interrupt server chain under kickstart 1.3.
  81. In other words prepare to reboot your Amiga if you run PaddleToy under 1.3
  82.  
  83. Here is the server source: as you can see D0 is correct...
  84.  
  85.         CNOP    0,BYTESPERLONG         ;TOT R W (TOT=READ*4+WRITE*4)
  86. server  move.l  pot0dat(a0),(a1)       ;28 (5+2) A1=ptr to shared memory
  87.         move.w  #POTF_START,potgo(a0)  ;16 (3+1)
  88.         moveq   #0,d0                  ; 4 (1+0) SERVER CHAIN
  89.         rts                            ;16 (4+0)
  90.  
  91.  
  92.                                DISTRIBUTION
  93.  
  94.  
  95. This  package  is released under the concept of freeware, the package must
  96. be  distributed  as one whole.  The distributor may charge a fee up to the
  97. cost of the medium for the entire package.
  98.  
  99. This   package,  or  part  of  it,  cannot  be  included  with  commercial
  100. distributions without written permission from me.
  101. This  document  is a written permission to include the package in the Fred
  102. Fish collection.
  103.  
  104.  
  105.                                NO WARRANTY
  106.  
  107.  
  108. This  package  is  provided  as  is,  without warranty of any kind, either
  109. expressed or implied.
  110. Should  the  package  prove  defective,  you assume the entire cost of all
  111. necessary  servicing,  repair or correction even if I have been advised of
  112. the possibility of such damages.
  113. I'm not responsible of the results of the use of the package.
  114.  
  115.  
  116.                                  SUPPORT
  117.  
  118.  
  119. If you have any suggestions, bug reports, or wish to let me know something
  120. about the package feel free to contact me at the E-Mail addresses below.
  121.  
  122. Fidonet.org:    Nicola Soggia (2:331/315.3)
  123. Amiganet.ftn:   Nicola Soggia (39:101/102.3)
  124. Internet/Arpa:  Nicola.Soggia@p3.f315.n331.z2.fidonet.org
  125. Usenet/Sublink: Nicola.Soggia@SkyLink.sublink.org
  126.  
  127. /\/ / /-<
  128.  
  129.